home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u525.dms / u525.adf / Utilities.Doc < prev    next >
Text File  |  2009-04-29  |  4KB  |  104 lines
  1.  
  3. Brush2Icon Documentation
  5.  
  6. *****************************************************************************
  7.  
  8.    This program will turn any iff brush or picture into an
  9. icon for the WorkBench.
  10.    I used to use 'zapicon' and it worked just fine except
  11. it used GADGHCOMP for the icon's hilighting mode which I
  12. personal think doesn't look to good.  The solution was to
  13. use zapicon to convert the iff brush to am icon and then
  14. load the icon into IconEd, change the hilite mode to
  15. BackFill and resave it.  The problem with that approach is
  16. that IconEd doesn't seem to like icons made with zapicon. 
  17. It loads them just fine but 30-40% of them it doesn't save
  18. them correctly.  I don't know what the problem is but after
  19. they'd been resaved with IconEd they would appear as almost
  20. total garbage on the WorkBench.  The other problem to that
  21. approach is that IconEd won't handle large icons.  So I
  22. finally sat down and wrote my own program to do what I
  23. needed.
  24.    Brush2Icon only runs from the CLI and takes the
  25. following format
  26.  
  27.    Brush2Icon name brush1 [-abrush2] [-backfill] [-tTYPE]
  28.  
  29. where 'name' is the name of the file your making an icon
  30. for. (ie. do NOT include the ".info")  'Brush1' is the IFF
  31. file that contains the picture to be used for the Icon. 
  32. The rest are optional.
  33.  
  34.    -abrush2 allows you to use a second IFF file for the
  35. selected image of the icon.  I think it is much easier to
  36. do this here than to make two icons and then run alticon on
  37. them.
  38.  
  39.    -backfill will set the hilite mode to BACKFILL instead
  40. of COMPLEMENT which is the default.  Note: this option is
  41. overridden by the -a option.
  42.  
  43.    -tTYPE sets the type of the icon.  The default type is
  44. PROJECT.  Valid types are TOOL, PROJECT, DRAWER, DISK and
  45. GARBAGE
  46.  
  47. examples.
  48.  
  49.    Brush2Icon Harv Face.pic
  50.  
  51. Creates an icon for the file 'Harv' (ie. it creates a file
  52. named 'Harv.info' using the iff image in the file
  53. 'Face.pic'.  The filetype will be PROJECT and the hilite
  54. type will be COMPLEMENT (GADGHCOMP)
  55.  
  56.    Brush2Icon Harv Face.pic -b -tTOOL
  57.  
  58. Same as above expect the filetype will be TOOL and the
  59. hilite type will be BACKFILL.
  60.  
  61.    Brush2Icon Progs Closed.pic -aOpened.pic -tDRAWER
  62.  
  63. Creates an icon for the drawer 'Progs'.  The icon will look
  64. like the image in the IFF file 'Closed.pic' then when it is
  65. clicked on or selected it will display the image in the
  66. file 'Opened.pic'.  the filetype is DRAWER and the hilite
  67. type is GADGHIMAGE.
  68.  
  69.    Brush2Icon
  70.  
  71. Prints out a few simple instructions.
  72.  
  73. Note: 1) If you make an alternate image be sure you save
  74. the two images in the same size.  (If you want an
  75. explanation just try it with different sized ones and see
  76. what happens. :-D )
  77.       2) This program doesn't strip extra bitplanes so if
  78. you draw a 16 color icon it 'SHOULD' save all 4 planes. 
  79. This is a waste of memory if you are only using a 2 plane
  80. WorkBench but if you have modified your WorkBench for more
  81. planes then it should allow you to make icons for it. 
  82. (Should means that I haven't actually tried it.  I don't
  83. personally strip the planes but PutDiskObject() might.)
  84.  
  85.  
  86.    I have uploaded the source in case you would like
  87. to add other features, change the defaults or just see if
  88. there are some nifty routines you can use in your own
  89. programs.  Actually there are a few but I will upload them
  90. separately with documentation in the near future.
  91.  
  92.    This program is Public Domain.  Please do NOT sell it
  93. or take credit for work that is not yours.  Thank you.
  94.  
  95.          Gregg Tavares
  96.          10500 National Blvd #24
  97.          Los Angeles, CA  90034
  98.  
  99.          PLINK: GreggT
  100.  
  101.  
  102.  
  103. *****************************************************************************
  104.